home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Internet / WWW / Perl_WWW_Utilities / total / links / README < prev   
Encoding:
Text File  |  1996-01-01  |  5.4 KB  |  100 lines
  1. ##############################################################################
  2. # Free for All Link Page
  3. # Created by Matt Wright        (mattw@misha.net)
  4. # Version: 2.1
  5. # Created On: 5/14/95                  Last Modified: 10/15/95
  6. # Script Archive:        http://www.worldwidemart.com/scripts/
  7. ##############################################################################
  8. # If you run into any problems while trying to configure this scripts, help  #
  9. # is available.  The steps you should take to get the fastest results, are:  #
  10. #       1) Read this file thoroughly                         #
  11. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  12. #               http://www.worldwidemart.com/scripts/faq/             #
  13. #       3) If you are still having difficulty installing this script, send   #
  14. #          e-mail to: scripts-help@tahoenet.com                     #
  15. #          Include any error messages you are receiving and as much detail   #
  16. #          as you can so we can spot your problem.  Also include the variable#
  17. #          configuration block that is located at the top of the script.     #
  18. #                                         #
  19. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  20. ##############################################################################
  21.  
  22. This is a script built for the World Wide Web that allows users to freely
  23. add links to your page in the sections that you specify.
  24.  
  25. File included in this script:
  26.         1) links.html - The HTML File users see
  27.         2) links.pl - The guts of the operations
  28.         3) README - This file (Installation information)
  29.         4) changelinks.pl - This file will put " around all your urls you may 
  30.                             have in your previous version.
  31.  
  32. If you have used the 2.0 version or previous you will need to manually edit 
  33. your links.html file and change all the <meta XXXX> tags to <!--XXXX--> tags.
  34.  
  35. To Install:
  36. a) You must have access to your server's cgi-bin
  37. b) Put the links.pl file into your server's cgi-bin
  38. c) Put the links.html file into any dir of your choice (must be user writable)
  39.  
  40. LINKS.PL
  41. This file is the file that pulls in your links.html and makes the necessary 
  42. changes to your links.html.  It will add the url of the user's choice.  You 
  43. must chmod this file 755 and place it in your server's cgi-bin.
  44.         EDIT VARIABLES IN THIS FILE:
  45.                 $filename = "real/location/of/links.html" 
  46.                         Real Location of your links.html file.
  47.                 $links_url = "http://your.server/actual/url/of/links.html" 
  48.                         URL Location of links.html file.
  49.                 $linkspl = "http://your.host.xxx/cgi-bin/links.pl";
  50.                         URL Location of links.pl.
  51.                 $datecom = "/path/to/date"
  52.                         Location of the 'date' command on your system
  53.  
  54. LINKS.HTML
  55. This file contains all of the links that users have added.  Users will be 
  56. automatically returned to this document.  You must place this document in a 
  57. directory with 777 file access and then chmod this file 777.  You will need to 
  58. edit the action="" part of the <form> tag so that points to your links.pl file 
  59. at your cgi-bin.  You will also want to change the bottom link so users can get 
  60. back to your home page.  You can change anything above the <form> tag also... 
  61. Just don't change the <!--XXXX--> tags unless you want to edit the script.
  62.  
  63. CHANGELINKS.PL
  64.         This file will change version 2.0 links file into a version 2.1 links 
  65. fiel, which are also parsable by a script called makelinkdb.pl which can 
  66. create a link database for my random link script.  Simply modify the $file 
  67. variable in this script to point to your links.html file and then run the 
  68. script.  It may not be a bad idea to make a backup copy of your link file 
  69. before hand, just in case.
  70.  
  71. -------------------------------------------------------------------------
  72.  
  73. Hopefully this is enough information to get your script up and running.  If 
  74. you want more information please mail me.
  75.  
  76. I love to hear feedback and if anyone can improve on this it would be greatly 
  77. appreciated.  There is no cost to use this script and you can freely modify it 
  78. any way you wish.  All that I ask is that you possibly include my name some 
  79. where in the file (not necessarily viewable by all users) and I would like to 
  80. know the url of where it is being used so that I can see my script in action!
  81. _____________________________________________________________________________
  82.  
  83. HISTORY
  84. Version 1.0     5/14 - Original links.pl created
  85. Version 2.0     5/20 - Patrick Kane re-wrote almost the entire script to make 
  86.                        it work better
  87. Version 2.1     8/5  - Added the count of links and date last modified to the 
  88.                        links.html file.
  89.                      - Changed all my <meta> tags to the appropriate comment 
  90.                        tag <!--XXXX-->
  91.                      - Added a datecom variable in the realization that just 
  92.                        the 'date' command was interfering with some of the 
  93.                        date commands located in the cgi-bin of some servers.
  94.                      - An HTML checker to remove all HTML tags a user might 
  95.                        try to put around their title.
  96.                      - Added quotes around the url to make the structure more 
  97.                        HTML compatible.
  98. __________________________________________________________________________
  99. -- Matt Wright mattw@misha.net - http://www.worldwidemart.com/scripts/
  100.